跳到主要内容

SPI 通信

在本章中,我们将学习 Luckfox Lume SPI 主机模式的设备树配置、回环测试以及 Python 和 C 程序通信方法。

1. SPI 子系统​

在 Linux 系统中,SPI 子系统是一套核心驱动框架,负责管理、控制挂载于 SPI 总线上的各类外设。SPI 子系统的官方详细文档可在内核源码路径 <Linux内核源码>/Documentation/spi 下查阅。

SPI 子系统两大核心组成:

  1. sysfs 接口 SPI 子系统借助 sysfs 导出一系列文件与目录,实现 SPI 总线及设备的配置与管理。相关节点存放于 /sys/class/spi_master、/sys/bus/spi/devices,用户空间可通过该接口读取、修改 SPI 设备属性。
  2. 用户态设备节点 每一个注册成功的 SPI 设备都会在 /dev 目录生成对应的字符设备节点,应用程序可通过标准文件 I/O 接口完成和外设的数据交互。设备节点命名格式一般为 /dev/spidevX.Y:X 代表 SPI 总线编号,Y 代表该总线上的片选设备编号。

2. SPI 测试(Shell)​

2.1 引脚分布​

SPICLKMISOMOSICS
SPI1物理脚23 / PD11物理脚21 / PD13物理脚19 / PD12CS0:物理脚24 / PD10

2.2 设备树配置​

  1. 板级设备树路径:

    device/config/chips/t153/configs/luckfox_lume/linux-5.10-origin/board.dts
  2. SPI1 主机及 CS0 从设备配置如下:

    &spi1 {
    pinctrl-0 = <&spi1_pins_default &spi1_pins_cs>;
    pinctrl-1 = <&spi1_pins_sleep>;
    pinctrl-names = "default", "sleep";
    sunxi,spi-bus-mode = <SUNXI_SPI_BUS_MASTER>;
    sunxi,spi-cs-mode = <SUNXI_SPI_CS_AUTO>;
    clock-frequency = <150000000>;
    sunxi,spi-num-cs = <1>;
    status = "okay";

    spidev@0 {
    compatible = "rohm,dh2228fv";
    reg = <0>;
    spi-max-frequency = <150000000>;
    spi-rx-bus-width = <1>;
    spi-tx-bus-width = <1>;
    status = "okay";
    };
    };
  3. 编译设备树:

    sudo ./build.sh dts

2.3 Buildroot​

  1. 在 buildroot 目录添加 spidev,使用关键字"spidev"进行搜索。

    cd <Luckfox_Lume_SDK>/
    ./build.sh buildroot_menuconfig

  2. 在搜索结果中找到并勾选"spidev",最后保存并退出。

  3. 编译执行:

    sudo ./build.sh
    sudo ./build.sh pack

2.4 查看设备​

root@luckfox:~# ls /dev/spidev*
/dev/spidev1.0

2.5 SPI 回环测试​

使用内核自带的测试工具;连接方式:杜邦线短接 第19脚 MOSI 与第21脚 MISO:

cd <Luckfox_Lume_SDK>/
export PATH="$PWD/out/toolchain/gcc-linaro-11.3.1-2022.06-x86_64_arm-linux-gnueabihf/bin:$PATH"
arm-linux-gnueabihf-gcc \
kernel/linux-5.10-origin/tools/spi/spidev_test.c \
-o spidev_test

将程序复制到开发板,确认 MOSI 与 MISO 已短接后,运行程序:

chmod +x spidev_test
./spidev_test -D /dev/spidev1.0 -s 1000000 -b 8 -p "hello Lume!" -v

执行结果:

3.SPI 测试(Python 程序)​

  1. 示例程序:

    #!/usr/bin/env python3
    import sys
    import spidev


    def main():
    tx_buffer = list(b"hello Lume!")
    spi = spidev.SpiDev()
    try:
    spi.open(1, 0)
    spi.max_speed_hz = 1_000_000
    spi.mode = 0
    spi.bits_per_word = 8

    rx_buffer = spi.xfer2(tx_buffer)
    print("tx_buffer:", bytes(tx_buffer).decode("ascii"))
    print("rx_buffer:", bytes(rx_buffer).decode("ascii", errors="replace"))
    if rx_buffer != tx_buffer:
    print("Loopback FAIL")
    return 1
    print("Loopback PASS")
    return 0
    except OSError as error:
    print(f"SPI error: {error}", file=sys.stderr)
    return 1
    finally:
    spi.close()


    if __name__ == "__main__":
    sys.exit(main())
  2. 打开SPI设备:

    spi.open(1, 0)
    spi.max_speed_hz = 1_000_000
    spi.mode = 0
    spi.bits_per_word = 8
    rx_buffer = spi.xfer2(tx_buffer)

    设置1MHz、Mode 0、8位数据,并执行一次全双工传输。xfer2() 返回接收数据。

  3. 执行程序:

    python3 SPI.py

    执行结果:

4. SPI 回环测试(C程序)​

  1. 完整代码:

    #include <fcntl.h>
    #include <linux/spi/spidev.h>
    #include <stdint.h>
    #include <stdio.h>
    #include <stdlib.h>
    #include <string.h>
    #include <sys/ioctl.h>
    #include <unistd.h>

    int main(void)
    {
    const char *device = "/dev/spidev1.0";
    uint8_t tx_buffer[] = "hello Lume!";
    uint8_t rx_buffer[sizeof(tx_buffer)] = {0};
    const size_t length = sizeof(tx_buffer) - 1;
    uint8_t mode = SPI_MODE_0;
    uint8_t bits = 8;
    uint32_t speed = 1000000;
    int spi_file = open(device, O_RDWR);

    if (spi_file < 0) {
    perror("Failed to open SPI device");
    return EXIT_FAILURE;
    }

    if (ioctl(spi_file, SPI_IOC_WR_MODE, &mode) < 0 ||
    ioctl(spi_file, SPI_IOC_WR_BITS_PER_WORD, &bits) < 0 ||
    ioctl(spi_file, SPI_IOC_WR_MAX_SPEED_HZ, &speed) < 0) {
    perror("Failed to configure SPI device");
    close(spi_file);
    return EXIT_FAILURE;
    }

    struct spi_ioc_transfer transfer = {
    .tx_buf = (uintptr_t)tx_buffer,
    .rx_buf = (uintptr_t)rx_buffer,
    .len = (uint32_t)length,
    .speed_hz = speed,
    .bits_per_word = bits,
    };

    int result = ioctl(spi_file, SPI_IOC_MESSAGE(1), &transfer);
    if (result < 0) {
    perror("Failed to perform SPI transfer");
    close(spi_file);
    return EXIT_FAILURE;
    }
    if (result != (int)length) {
    fprintf(stderr, "Incomplete SPI transfer: %d bytes\n", result);
    close(spi_file);
    return EXIT_FAILURE;
    }

    printf("tx_buffer: %s\n", (const char *)tx_buffer);
    printf("rx_buffer: %s\n", (const char *)rx_buffer);
    int matched = memcmp(tx_buffer, rx_buffer, length) == 0;
    puts(matched ? "Loopback PASS" : "Loopback FAIL");
    close(spi_file);
    return matched ? EXIT_SUCCESS : EXIT_FAILURE;
    }
  2. 打开 SPI 设备:

    int spi_file = open(device, O_RDWR);

    以读写方式打开 /dev/spidev1.0。打开失败时输出错误并退出。

  3. 配置 SPI:

    ioctl(spi_file, SPI_IOC_WR_MODE, &mode);
    ioctl(spi_file, SPI_IOC_WR_BITS_PER_WORD, &bits);
    ioctl(spi_file, SPI_IOC_WR_MAX_SPEED_HZ, &speed);

    设置 Mode 0、8位数据和1MHz时钟。完整程序检查每次配置的返回值,配置失败时不继续传输。

  4. 发送和接收数据:

    int result = ioctl(spi_file, SPI_IOC_MESSAGE(1), &transfer);
    int matched = memcmp(tx_buffer, rx_buffer, length) == 0;
  5. 交叉编译:

    export PATH="<Luckfox_Lume_SDK>/out/toolchain/gcc-linaro-11.3.1-2022.06-x86_64_arm-linux-gnueabihf/bin:$PATH"
    arm-linux-gnueabihf-gcc -Wall -Wextra -O2 SPI.c -o SPI
  6. 运行程序:

    chmod +x SPI
    ./SPI

    执行结果: